home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / print / sqc250.zip / SQC250.DOC < prev    next >
Text File  |  1991-11-09  |  16KB  |  463 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                    SQC v2.50
  10.                          The Advanced Printer Utility
  11.                    Copyright (C) 1990-1991 Daniel Baumberger
  12.                            Dynamic Designs Software
  13.  
  14.  
  15.        STANDARD DISCLAIMER:
  16.        ====================
  17.             This  software  is provided  AS-IS.   There is  NO warranty,
  18.        either  expressed or implied.   Damage resulting  from the use or
  19.        misuse of this software is NOT a responsibility of the author.
  20.  
  21.        INTRODUCTION
  22.        ============
  23.             SQC  is a powerful printer utility that allows printer codes
  24.        to  be sent to the  printer from the MS-DOS  command line.  Codes
  25.        may  be  specified  by pre-defined  opcodes,  literal characters,
  26.        and/or decimal, hexadecimal, or octal ASCII codes.
  27.             SQC  also  allows printing  of  files with  or  without page
  28.        breaks.   The user can specify the number of lines per page.  SQC
  29.        will then insert page breaks after the specified number of lines.
  30.        SQC  also supports "continuous" printing, i.e. files that already
  31.        are formatted. 
  32.             Version 2.50 adds more features to the list.  A totally new,
  33.        object-oriented  printer  interface was  designed  for SQC.   The
  34.        printer  "object" controls the printer at  the BIOS level.  Error
  35.        checking  is done on the character  by character basis.  SQC will
  36.        NOT print a character if the printer won't accept it.
  37.             When  run with no command line arguments, SQC will print the
  38.        current  status as  returned by  BIOS and  what it  means to you.
  39.        This is helpful in figuring out what is wrong with your printer.
  40.             New  command lines  switches were  added: /PRINT,  /LEN, and
  41.        /CHECK.   /PRINT is  the same as /P:.   /LEN is  the same as /L:.
  42.        /CHECK  replaces  the  old "/C"  parameter.   /CHECK  also  has a
  43.        shorter  form.  Refer to the  sections on COMMAND LINE PARAMETERS
  44.        for syntax.
  45.             SQC  now supports more printer ports.   LPT1, LPT2, and LPT3
  46.        are  directly supported.  They are  specified by the /LPT# switch
  47.        described below.
  48.             Some items were dropped out of SQC v2.50.  The numerous help
  49.        files  are gone.  The main help  is now accessible through the /?
  50.        switch,  as used  in MS-DOS 5.0.   The  environment variables are
  51.        gone.   In v3.0,  a new environment  variable will be introduced.
  52.        It  will be a mini command line that gets executed EVERY time SQC
  53.        is run.
  54.             Upon  removal of  these features,  SQC's .EXE  file size was
  55.        reduce almost 50%!
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.        GENERAL SYNTAX
  74.        ==============
  75.             SQC's syntax looks like this:
  76.  
  77.        SQC [/Options] [Codes/Opcodes]
  78.  
  79.        The Options include:
  80.          /C[ON | OFF]      <- Turn printer checking on/off
  81.          /CHECK=[ON | OFF] <- Turn printer checking on/off
  82.          /LPT#             <- Select LPT port #
  83.          /P:fs             <- Print files matching fs
  84.          /PRINT=fs         <- Print files matching fs
  85.          /L:#              <- Set the pagelength to #
  86.          /LEN=#            <- Set the pagelength to #
  87.          /?                <- Display a help screen with Options
  88.  
  89.        SQC  will display the current status of the printer when run with
  90.        no  command line parameters  or options.   See PRINTER STATUS for
  91.        details.
  92.  
  93.        Codes  are explained in the section CODES.  Opcodes are explained
  94.        in the section OPCODES.
  95.  
  96.        PRINTER CHECKING
  97.        ================
  98.             By  default,  SQC  checks with  the  BIOS to  make  sure the
  99.        printer  is ready.   If not, SQC will  display a message allowing
  100.        you  to  fix the  problem  or abort  the  program.   With printer
  101.        checking  off, SQC prints  the character via the  BIOS.  The BIOS
  102.        will  sit  and wait  until the  printer is  ready, or  forever if
  103.        necessary.    Due to  this,  it is  better  to leave  the printer
  104.        checking  on.  However, printer checking does cause a little time
  105.        overhead because it makes a BIOS call and does some checking.
  106.             To  turn the  printer checking  off, you  can use  either of
  107.        these two forms:
  108.  
  109.        SQC /COFF
  110.        SQC /CHECK=OFF
  111.  
  112.             Either  way is correct.   NOTE: Turning printer checking off
  113.        by  the  switch  ONLY turns  it  off  for that  execution  of the
  114.        program.   The  next time  SQC is run,  it will  use the standard
  115.        defaults.
  116.  
  117.             Similarly,  the printer checking can  be turned on in either
  118.        of these two forms:
  119.  
  120.        SQC /CON
  121.        SQC /CHECK=ON
  122.  
  123.             Using  these switches, one can turn the printer checking off
  124.        for some parameters and on for others.  For example,
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.        SQC /COFF ESC @ /CON /PRINT=*.DOC
  140.  
  141.             In  this example, the printer checking  is turned off and an
  142.        opcode (escape) and a character are sent.  Then, printer checking
  143.        is re-established and SQC will print all the files matching *.DOC
  144.        with printer checking.
  145.             NOTE:  Case is  insignificant.  /CON  = /con =  /CoN = /cOn,
  146.        etc.
  147.  
  148.        SELECTING A PORT
  149.        ================
  150.             SQC v2.50 now allows other LPT ports to be used.  To specify
  151.        a different port, use the /LPT# command.  # should be replaced by
  152.        the  number of the port.  Valid ports  are 1, 2, and 3.  Anything
  153.        else will generate an error.  For example,
  154.  
  155.        SQC /LPT2 ESC @ /LPT1 /PRINT=*.TXT
  156.  
  157.             In  this  example,  ESC  and '@'  are  sent  to  the printer
  158.        connected  to  LPT2:.    Then,  all  .TXT  files  in  the current
  159.        directory   are  printed  on  LPT1:.    Again,  case  of  LPT  is
  160.        insignificant.
  161.  
  162.        PRINTING FILES
  163.        ==============
  164.             SQC  can  print  files with  or  without page  breaks.   SQC
  165.        supports   any  size  pages.    A  size  of  0  will  generate  a
  166.        "continuous"  printout.  SQC will not send form feeds to skip the
  167.        partitions.    The  default  in  SQC  v2.50  is  now  continuous.
  168.        Continuous  printing can be  used for files  that already contain
  169.        page formatting commands.
  170.             Two switches are available to specify the file specification
  171.        to  print: /P:  and /PRINT=.   /P: was used  in previous version.
  172.        /PRINT=  is ONLY  available in  v2.50.   Both take  a MS-DOS file
  173.        specification.   A file specification can be a single filename or
  174.        use  either  or both  of  the MS-DOS  wildcards:  ? and  *.   For
  175.        example,  *.DOC  specifies  all  files  with  the  DOC extension.
  176.        A??.A?? will print any files that start with and a, have two more
  177.        characters,  and have an extension that  starts with an A and has
  178.        two  more  characters.    This  will  match  files  like AAA.AAA,
  179.        AZZ.ABC, etc.
  180.             In version 2.50, SQC defaults to continuous print.  To split
  181.        pages after so many lines, one uses the /L: or /LEN= parameter.
  182.             Here are some examples of printing commands:
  183.  
  184.        SQC /LEN=60 /PRINT *.MOD
  185.        SQC /L:0 /P:*.?
  186.  
  187.             The first example prints all .MOD (Modula-2) files splitting
  188.        pages after 60 lines.  The second example continuously prints all
  189.        files  with a  one character extension.   NOTE: SQC  sends a form
  190.        feed  to the printer between files so  that each file starts on a
  191.        new page.
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.             What  happens if  you start printing  and find  out that you
  206.        don't want to print the files?  Pressing a key aborts printing of
  207.        the current file only.  Pressing a key many times will abort more
  208.        files.   At  present, there  is no way  to abort  the whole print
  209.        process  (unless you turn off the  printer and select the "abort"
  210.        option when SQC reports an error).
  211.  
  212.        CODES
  213.        =====
  214.             Codes   can  be  in